home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 34.zip / BS1 part 34 / Cando v1.01 NTSC.adf / ReadImportant! < prev    next >
Text File  |  1989-12-11  |  11KB  |  313 lines
  1. The CanDo How To Book, Version 1.0: 
  2.  
  3. INOVAtronics, Inc.
  4. 8499 Greenville Ave. Suite 209B
  5. Dallas, TX 75231
  6. USA
  7. Phone: (214) 340-4991
  8. BBS: (214) 357-8511
  9.  
  10. Errata-On-Disk
  11.  
  12. The following is a list of minor corrections to the CanDo documentation,
  13. listed in the order of the sections of the manual.  Also included here is
  14. documentation for SerialManager, a serial communications ARexx micro server,
  15. and AnimToBAnim, a program that converts full screen ANIMs to full or
  16. partial screen BrushAnims.  Documentation is included for another program
  17. that removes CanDo decks from your system.  This is called ShutDownDeck
  18. and is found on the CanDoExtras disk.
  19.  
  20. Included in the package is a flyer for the CanDo BBS.  This bulletin
  21. board system is owned and operated by Preferred Marketing Services, a
  22. third party company, and we're happy to be working with them.  As always,
  23. INOVAtronics provides direct support to all registered CanDo owners.
  24. Please refer to page 1-4 of CanDo's manual to find out how you can get help.
  25.  
  26. ---------------
  27. First of all...
  28. ---------------
  29. Our phone number on the back manual cover is incorrect.  It should read
  30. 214-340-4991.
  31.  
  32. ---------------------------------
  33. CanDo Installation
  34. ---------------------------------
  35. Floppy Disk Based Amiga's -
  36.  
  37. The CanDoInstaller program does not copy the "Decks" drawer or other
  38. optional files to your WorkBench disk.  Please use your working CanDo disk
  39. to run the sample Decks, Sounds, Images, etc.  CanDoInstaller installs the
  40. following files:
  41.  
  42. CanDo
  43. CanDo.info
  44. c/DeckRunner
  45. c/DeckRunnerNoLibrary
  46. c/DeckBinder
  47. libs/CanDo.library
  48. L/ApplicationIcon.info
  49.  
  50. These files are essential for CanDo and it's Decks to operate correctly.
  51.  
  52. Hard Disk Installation -
  53.  
  54. The CanDoInstaller program installs CanDo in a drawer on the root
  55. directory.  CanDo and all the support files on the CanDoExtras disk
  56. are copied to this directory.  The following files are installed:
  57.  
  58. C:DeckRunner
  59. C:DeckRunnerNoLibrary
  60. C:DeckBinder
  61. Libs:CanDo.library
  62. L:ApplicationIcon.info
  63.  
  64. As above, the sample Decks, Sounds, Images, etc., on your CanDo disk
  65. are not copied on your Hard Disk.
  66.  
  67.  
  68. ---------------------------------
  69. Section 2:Tutorial (You CanDo It)
  70. ---------------------------------
  71.  
  72. 2-6:Step 28
  73. -----------
  74. The Button's Origin Point and Size are determined by pressing the Left
  75. Mouse Button and then moving the mouse (while holding the button down) to
  76. the desired size.  This procedure can be altered from the default
  77. click, drag, release, to the operation described in the manual which
  78. is click, release, move then click.  The CoordinateDrag ToolType may
  79. be modified in CanDo's Icon by highlighting it and selecting Info from
  80. the WorkBench menu.
  81.  
  82. 2-8:Step 42 
  83. -----------
  84. The step to be repeated is Number 39, not 38.  Also, in this step, the user 
  85. is encouraged to change button border styles.  While we haven't used 
  86. borders in this example, they are self-explanatory and fun to work with.
  87.  
  88. 2-11:Step 19 and 22 
  89. -------------------
  90. If you should study the deck on the Extras disk that corresponds to this 
  91. tutorial, you may find that your pathnames differ from those in the deck on 
  92. the disk.  Use the DOS Editor Tool to help locate and run other applications.
  93. To run other Decks that have not been bound, you must precede the Deck
  94. name with C:DeckRunner.  The Phone Index Button on page 2-12 is incorrect.
  95. The Program is actually CanDo:Decks/Phone which is an un-bound deck.  Your
  96. final script should read:
  97.  
  98. Dos "c:run >NIL: <NIL: C:DeckRunner CanDo:Decks/Phone"
  99.  
  100.  
  101. 2-13:Step 23
  102. ------------
  103. Disregard the third and final line of the script in this step (PrintText).
  104. The script is as follows:
  105.     
  106.     Setpen 1
  107.     PrintText "Sound Samples",35,48
  108.  
  109.  
  110. -----------------
  111. Section 4:Objects
  112. -----------------
  113.  
  114. 4-22:Menus
  115. ---------------------------------------
  116. Currently the Menus do not support extended print styles.
  117.  
  118.  
  119. 4-31:Document Editors and Lists
  120. ---------------------------------------
  121. Currently the Document Editors handle non-proportional fonts only.  These
  122. fonts include topaz and Courier and are supplied by Commodore on your
  123. original system disks.
  124.  
  125. 4-35:Animation Object 
  126. -----------------------------
  127. When creating an animation object, you must reference the brush animation
  128. with the exact path and filename you specified when loading and/or showing
  129. it.  The animation object cannot refer to a brush animation that has been
  130. given another name with the LoadBrushAnim Command. 
  131.  
  132.  
  133. ------------------
  134. Section 6:Commands
  135. ------------------
  136.  
  137. 6:30-33:Graphics
  138. ------------------
  139. The PrintText Command on page 6-33 is documented incorrectly.  The
  140. x,y coordinates should be specified AFTER the "string".  The syntax
  141. should be...
  142.  
  143.     PrintText "string",<x>,<y>
  144.  
  145. The example should read as follows:
  146.  
  147.     PrintText "Hello World",50,50
  148.  
  149. *********************************************************************
  150.  
  151. The example for the SetPrintFont Command on page 6-33 is incorrect.
  152.  
  153.     SetPrintFont "topaz"
  154.  
  155. Make sure that the capitalization for the font's name corresponds exactly
  156. with the real thing.
  157.  
  158. *********************************************************************
  159.  
  160. The example for the DrawTo Command on page 6-30 is incorrect.  It should
  161. read as follows:
  162.  
  163.     DrawLine 50,50,100,50
  164.     DrawTo 100,100
  165.  
  166. Notice the example uses the Command "DrawLine".  There is not a "Line"
  167. Command.
  168.  
  169. 6-31:GetRGB and 6-32:SetRGB
  170. ---------------------------- 
  171. These Commands use color values ranging from 0 to 255 for each of the red, 
  172. blue or green components that make up the color.  This enables CanDo to 
  173. take advantage of future Amiga hardware that can display more than the 
  174. current 4096 colors.  Currently, paint programs (Deluxe Paint) use values 
  175. from 0 through 15.  Their equivalents in CanDo may be obtained by 
  176. multiplying them by 17.
  177.  
  178. 6-40:Animation
  179. ----------------------
  180. Sequence motion shows ALL frames of an animation before moving it.
  181.  
  182. 6-51:Replace
  183. ----------------------
  184. The description for NOCASE should be as follows...
  185.  
  186.     NOCASE indicates the "fromtext" will match even if some of the
  187.     character's is not the same case.
  188.  
  189.  
  190. --------------------
  191. Section 7:Appendices
  192. --------------------
  193. 7-10:Error Messages/Syntax Errors
  194. "Conflicting switches Specified" should read:
  195. Conflicting KEYWORDS Specified
  196.  
  197.  
  198.  
  199.  
  200. -----------------------------------------------------------------------
  201. Additional utilities located on the CanDoExtras disk in the CLI-Utilities
  202. directory.
  203. -----------------------------------------------------------------------
  204.  
  205. SerialManager - AREXX microserver
  206.  
  207.     SerialManager is a standalone program to handle communications
  208.     over the Amiga's serial port.  This enables your CanDo application
  209.     to communicate with external hardware such as a laserdisc player,
  210.     video equipment, or anything that can send and receive text messages.
  211.     You must run SerialManager from a CLI or Shell, or from CanDo's
  212.     DOS command.
  213.  
  214.     SerialManager -l{port} -t{talkto} -u{unit} -d{devicename} -p{prefix}
  215.  
  216.     ARexx Commands Understood: (Not caps sensitive)
  217.  
  218.     Send {text}
  219.     SetTalkTo {portname}
  220.     SetPrefix {prefix}
  221.     SetConfig {as in F8N1{baud}}
  222.     SetCRMode {On,Off}  -- this waits on CR to end else waits on NIL
  223.     SetHandshaking {XON,DTR,NONE}
  224.     Quit -- shut down the serialmanager
  225.     Abort -- Use when SerialManager hangs on replying to a message from
  226.         an ARexx message.  Only works in that case.  Must be sent
  227.         by external program as your main program will be hung waiting
  228.         on its reply.
  229.  
  230. NOTE : DTR works by setting 7Wire mode and turning XON/XOFF off.
  231.  
  232. -----------------------------------------------------------------------
  233. AnimToBAnim - A utility to convert full screen Anims to Deluxe Paint III
  234.             compatible brush animations.
  235.  
  236.     ANIM REV.5 TO BrushANIM REV.5 Converter -- Version 1.1
  237.     Copyright (c) 1989 by Silver Fox Software, All Rights Reserved
  238.     Written by James Nelson
  239.     Developed for INOVAtronics -- Creators of CanDo!
  240.  
  241. Syntax:
  242.     animtobanim {animname} {banimname} [{x} {y} {w} {h}]
  243.  
  244. Required Arguments:
  245.     {animname}  - name of the source anim file
  246.     {banimname} - name of the destination brush animation file
  247.  
  248. Optional Arguments:
  249.  
  250.     {x} {y}     - upperleft corner of the rectangle to clip
  251.     {w} {h}     - size of the rectangle to clip
  252. -----------------------------------------------------------------------
  253.  
  254. ShutDownDeck {DeckName}
  255.  
  256. A file is included on the CanDoExtras disk called "ShutDownDeck."  Its
  257. purpose is to shut down a running CanDo Deck.  In the event that your
  258. Deck becomes caught in a loop and appears to be hung, you may execute
  259. this command and quit the application.  For example if your Deck had
  260. a script as follows:
  261.  
  262.     Let count=0                ;initialize count to zero
  263.     While count<10            ;loop until count becomes 10 or greater
  264.         PlaySound "CanDo:Sounds/DogBark.snd"
  265.         Let cnt=cnt+1        ;we misspelled our count variable
  266.     EndLoop                    ;we'll never end
  267.     NextCard                ;go to the next card        
  268.  
  269. As you can see, this While...EndLoop will never end since the variable
  270. "count" does not get incremented.  In order to remove this hung Deck
  271. from your system, the user would do the following.  
  272.     
  273.     1. Go to an active CLI or shell
  274.     2. Type:  (pathname/)ShutDownDeck DeckName
  275.  
  276.     DeckName, in this case, is the name of the hung deck.  It must 
  277.     mirror the deck name exactly, including case-sensitivity.
  278.  
  279. If the deck is truly hung, it will be removed immediately, returning the
  280. user to the CLI, shell, or Workbench.  If the specified deck is actually 
  281. running correctly, it will be removed after its next event (such as 
  282. clicking one of the deck's buttons). 
  283.  
  284. -----------------------------------------------------------------------
  285. TheBinder
  286.  
  287. The Binder, located on the CanDo disk, is used to "Bind" a CanDo Deck
  288. so that it can be run as a stand alone program.  Decks you create with
  289. CanDo are actually projects that use a small program called DeckRunner
  290. in your C: directory to launch themselves.  If you want to run a Deck
  291. from CLI, you must precede the Deck's name and path with DeckRunner.
  292. Example:
  293.  
  294.     DeckRunner CanDo:Decks/ApptCal
  295.  
  296. After you Bind the Deck, you can start it like any other application.
  297. Example:
  298.  
  299.     CanDo:Decks/ApptCal
  300.  
  301. When running TheBinder you must specify the Deck you would like to
  302. Bind and then the destination for the bound application.  A file
  303. requester may be used for this by clicking on the "Deck Name" or "Dest
  304. Name" text.  You may also use menu selections to obtain the file
  305. requester.  TheBinder defaults to "Yes" for the library selection.
  306. This means your program will need to share CanDo's library.  If you
  307. select "No" your application will not need this library and may be
  308. used on other Amigas without CanDo.  This results in the application
  309. being somewhat larger in size.
  310.  
  311. Please refer to page 1-3 for more information about the two types
  312. of bound applications.
  313.